|
|
|
|
- Modificar el tipo de bloqueo en un registro
- Efecto del modo de bloqueo
- Error de bloqueo
- Número de bloqueos
- Conector Nativo SQL Server: Bloqueo de escritura
- Gestión de bloqueos en OLE DB
- Persistencia del bloqueo
<Fuente>.LockRecNum (Función)
No disponible con estos tipos de conexión
Bloquea un registro y e impide que las demás aplicaciones accedan a él. El registro podrá desbloquearse con la función <Fuente>.UnlockRecNum. Observación: Después de llamar a la función <Fuente>.LockRecNum, se pueden producir los siguientes casos: - El registro ya está bloqueado por otra aplicación: no se puede realizar el bloqueo.
- El archivo de datos que contiene el registro está completamente bloqueado.: no se puede realizar el bloqueo.
Por defecto, se realiza una gestión automática de errores de bloqueo y de conflictos de modificación (excepto en el código de procedimientos almacenados). La gestión automática de errores se puede personalizar o desactivar en cualquier momento con la función <Fuente>.OnError. La función HErrorLock devuelve True si se produce un problema de bloqueo. Atención: La función <Fuente>.LockRecNum debe utilizarse con precaución: durante el bloqueo, el registro no se vuelve a leer. Por lo tanto, puede que se haya eliminado o modificado desde la última vez que se accedió a él. Se recomienda utilizar <Fuente>.Read con una opción de bloqueo. // Lock a record in the Customer data file Customer.LockRecNum(hRecNumCurrent, hLockReadWrite) // Process on the record ... // Restore access to the record Customer.UnlockRecNum()
Sintaxis
<Result> = <Source>.LockRecNum([<Record to lock>] [, <Lock>])
<Result>: Booleano - True si se realizó la operación,
- False si se produce un problema. La función HError permite identificar el error.
<Source>: Tipo de fuente especificada Nombre del archivo de datos utilizado. <Record to lock>: Entero opcional Número del registro a bloquear. Si no se especifica este parámetro, <Fuente>.LockRecNum será manipular el Record actual. <Lock>: Constante opcional de tipo Integer Sirve para definir el tipo de bloqueo establecido en el Record. | | hLockNo | Ningún bloqueo: otras aplicaciones pueden leer o modificar el registro. | hLockReadWrite | Bloqueo de lectura/escritura: otras aplicaciones no pueden leer ni modificar el registro del archivo de datos. La otra aplicación no podrá bloquear el Record o el el archivo de datos. | hLockWrite (valor predeterminado) | Bloqueo de escritura: otras aplicaciones pueden leer el registro del archivo de datos pero no modificarlo. La otra aplicación no podrá bloquear el Record o el el archivo de datos. |
Observaciones Modificar el tipo de bloqueo en un registro Para modificar el tipo de bloqueo de un registro, llame a la función <Fuente>.LockRecNum con el tipo de bloqueo deseado. No es necesario desbloquear el registro. Efecto del modo de bloqueo Si el modo de bloqueo el archivo de datos se establece en hModeMono (ver <Fuente>.Mode ), <Fuente>.LockRecNum 02f0045004c0054003000300030003000300030002f002300 no tiene efecto. Error de bloqueo Si el registros ya está bloqueado, la solicitud de bloqueo se repite HNbRetry veces (50 por defecto). Si al cabo de H.NbRetry intentos no se puede bloquear el archivo de datos, la función HErrorLock devuelve True. La variable H.Level indica si el registro o el archivo de datos está bloqueado. Número de bloqueos El número de registros que se pueden bloquear individualmente en un archivo de datos es ilimitado.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|